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k INTRODUCTION AND OVERVIEW 
1.1 BACKGROUND 

This Is one of several Interface Software modules developed by 
the Hardware Development Group to provide an Interface between the 
Communication Software and Lacs hardware. Basically, It is a 
firmware module controlling hardware functions and yet is written In 
"c" language and Is running under the control of the Kernel 
Operating System environment. 

This Interface supports a physical I/O Interface between the 
Level 6 and Lan controller. All lOLDs that are destined for this 
controller are assembled and dispatched to various layers which 
require communication with Level 6. This module can be viewed as an 
extension of the Kernel Service function. 


1 .2 BASIC PURPOSE 

The basic function of the module Is to recognize the folds that 
are Issued by a CPU and dispatch them to Its destination according 
to an entry in the channel table which is previously setup by the 
user. 


1 .3 



BASIC STRUCTURE 

This module essentially consists of three sections.The first 
section initializes the I0LD queues and hardware enviroment for 
accepting lOLDs from Level 6. The second section contains the main 
routine looking for messages from its own mailbox to perform mailbox 
registration and presentation of channel mailbox Information that 
specifies where an I0LD may be dispatched. The third section Is the 
I0LD Interrupt handler. It assembles the Incoming lOLDs from the 10 
queues Into messages and dispatches them to their destination 
according to their channel mailbox table entry. It also manages the 
queues for the hardware to continue to accept lOLDs from the 
megabus. 


1 .4 BASIC OPERATION 

The process starts with the Initialization code. It programs the 
dma chip with two queue pointers and sets up the control registers 
ready for lOLDs. The queues are cleared to zero. The Interrupt 
routine to handle the next I0LD queue Is registered with the 
Kernel. Now it Is ready to accept messages from the user to register 
their mailbox entries. When an I0LD arrives the channel associated 
with It will be used to pickup the entry. It Is this entry that the 
I0LD will be dispatched to. During the registration no I0LD will be 
allowed until an event registration Is comp Ieted.Then the start_to 
lold information will be sent to the event mailbox. Only this time, 
a signal Is given to hardware to enable megabus 10 reception. The 
operation Is under the Kernel O.S. environment. 
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2. EXTERNAL SPECIFICATION 


2.1 OWNED DATA STRUCTURES 

A data structure Is created to handle I/O orders. The "c" 
Dec Iara11 on: 


struct § 


struct 


short ch_fc; /* channel number and function code */ 

long *l6_address;/* Level 6 memory address */ 
short range; /* range */ 

tIOITEM 


§ 

I0ITEM lo I !stOC32]; 
I0ITEM lollIstlC32]; 
I0ITEM loj!st2C32]; 
I0ITEM lojIst3[32]; 
tDataDes; 


/* first lo queue list */ 
/* second lo queue list */ 
/* third lo queue list */ 
/* fourth lo queue list */ 


The physical layout for DataDes: 



800400 


800500 


800600 


800700 


I0LD queues struct 




A mailbox table for 64 channels and an Event Is created during 
startup. This table contains all mailbox Ids. When an fold comes 
the channel associated with this told will be used to pickup the 
mailbox Id from the table and dispatch to that mailbox. An zero 
entry will dispatch to the event mailbox. A read or write command 
to the table Is permitted any time. 
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*V.2 EXTERNAL INTERFACES 

The 10 Dispatcher Is driven by two external events. A 
channel mailbox regIstratI on(write channel mailbox Id) or read 
channel mailbox Id Is accomplished with the O.S. sendmsg call. The 
message type Is register norma I,reglster event, read normal,or 
read event. The M c" Declaration for the message: 


struct chan mbld § 


MSG 

m 

/* 

short 

chan_nmb 

/* 

MB ID 

mb I d 

/* 

MB ID 

ret_mbId 

/* 

short 

t; 

ret_code 

/* 


kernel message header */ 
channel number bit 10 - 15 */ 
mailbox Id for this channel */ 
return malI box Id */ 
normal = 0,undefined type=-1*/ 


When an event mailbox Is registered for the first time the 
start I/O fold being queued up by the prom firmware Is sent to the 
event mailbox and hardware Is enabled to accept any 10 oders. 
When the cpu Issues an 10 order to lac controller the hardware put 
It Into the queue and cause a level 4 68000 Interrupt. The 10 

Dispatcher Is activated and uses the following M c" declaration 
to dispatch the fold: 


struct 1oIdmsg§ 


MSG 

m 


/* 

kernel message 

header */ 


short 

chanfc 

/* 

channel number 

and function 

code*/ 




/* 

bit 0 -9 channel# 10 - 15 * 

1 OLD*/ 

1 ong 

*16. 

_addr 

/* 

1cb address In 

Level 6 

*/ 

short 

1 cb 

_i nf 

/* 

t 

protocal id and 

• — 

9 

1cb size 

*/ 



2.3 INITIALIZATION REQUIREMENTS 

The initialization and main entries are part of the system 
table, CS1 file. When the system Is up this process Is also 

ready. The mailbox Id for this process Is "lODISP". The mailbox 
table Is created and Is cleared to zero. 10 queues are setup and 
cleared to zero. The dma chip Is setup and Is ready. However, 
Registration of the Interrupt routine to handle 10 with the O.S. 
must done when the system is powered up. No 10 orders would be 
accepted until event registration Is completed first. 


2.4 TERMINATION REQURIEMENTS 

There Is no termination requirement for this 10 Dispatcher as 
long as the Lacs board Is up. 
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2.5 ENVIRONMENT 

The code is In "c M control megabus Interface and operate under 
the environment of the Bridge Kernel. 


2.6 TIMING AND SIZE REQUIRMENTS 

The size of this module is approxmately 2k words. 


2.7 ASSEMBLY AND LINKING 

The source code name for this Is Iac_ lo.c and is In the 
directory /usr/dvI p/megabus. The binary file I ac_ io.b must 

linked with the usr/dvI p/kerne I to create a loadable bound unit. 


2.8 TESTING CONSIDERATIONS 
None 


2.9 DOCUMENAT I ON CONSIDERATIONS 

The source code Is written In "c" language and Is 
seIf-expI anatory. 


2.10 OPERATING PROCEDURES 
None 


2.11 ERROR MESSAGES 
None 
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INTERNAL SPECIFICATION 
OVERVIEW 

The basic function of the 10 Dispatch is to honor the requests 
from users to register or obtain channel mailbox Id for a given 
channel. An I0LD Interrupt handler is Implemented to assemble and 
dispatch I0LDS that are placed by the hardware In the 
pre-assigned queues. The module is linked and run under the 
control of the Bridge Kernel. 


3.2 SUBCOMPONENT DESCRIPTION 


3.2.1 10 HANDLER 

This handler is hardware Interrupt driven. Upon entry Into the 
routine It scans the hardware queue for fold. The channel number 
associated with the Told will be used as an Index to the channel 
mailbox table to obtain the mailbox Id. Then the fold will be 
dispatched to that mailbox Id. The routine resumes scan until all 
(olds are dispatched. 


3.2.2 CHANNEL MAILBOX REGISTRATION 

A channel mailbox table Is setup to accommodate al I 64 
channels plus and event mailbox Id. A user may send a 

registration message to request to put an entry for or read a 

particular channel or event Id. When a user.registers the event 

mailbox Id with this component for the first time It will 

dispatch the start 10 I0LD which Is placed by the prom firmware 

1 In specific temporary buffer to the event mailbox Id. The 

■ component Is always ready to receive from its own mailbox for 

messages. A brecelve Is called. 


3.2.3 10 QUEUE REQUEST INTERRUPT HANDLER 

When the DMA chip runs out a queue It Interrupts for another 
one. The routine responds the request by consulting the list 

which will specify which one of the four queues should be 

programmed Into the chip . Before returning to the Kernel It must 
reset the block transfer complete bit In the channel status 

regIster. 


3.3 FUTURE DEVELOPMENT AND MAINTENANCE 
as required 
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4. PROCEDURAL DESIGN 
none 
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INTRODUCTION AND OVERVIEW 
BACKGROUND 

This is one of several Interface Software modules developed by 
the Hardware Development Group to provide an interface between the 
Communication Software and Lacs hardware. Basical I y , It is a 
firmware module controlling hardware functions and yet is written in 
"c" language and is running under the control of the Kernel 
Operating System environment. 

This interface supports a physical 1/0 Interface between the 
Level 6 and Lan controller. All lOLDs that are destined for this 
controller are assembled and dispatched to various layers which 
require communication with Level 6. This module can be viewed as an 
extension of the Kernel Service function. 

BASIC PURPOSE 

The basic function of the module is to recogn I ze ■. the iolds that 
are issued by a CPU and dispatch them to its destination according 
to an entry in the channel table which is previously setup by the 
user. 

BASIC STRUCTURE 

This module essentially consists of three sections.The first 
section initializes the I0LD queues and hardware enviroment for 
accepting lOLDs from Level 6. The second section contains the main 
routine looking for messages from its own mailbox to perform mailbox 
registration and presentation of channel mailbox information that 
specifies where an I0LD may be dispatched. The third section Is the 
I0LD Interrupt handler. It assembles the Incoming lOLDs from the 10 
queues Into messages and dispatches them to their destination 
according to their channel mailbox table entry. It also manages the 
queues for the hardware to continue to accept lOLDs from the 
megabus. 

BASIC OPERATION 

The process starts with the initialization code. It programs the 
dma chip with two queue pointers and sets up the control registers 
ready for lOLDs. The queues are cleared to zero. The interrupt 
routine to handle the next I0LD queue is registered with the 
Kernel. Now it is ready to accept messages from the user to register 
their mailbox entries. When an I0LD arrives the channel associated 
with It will be used to pickup the entry. It is this entry that the 
I0LD will be dispatched to. During the registration no I0LD will be 
allowed until an event registration is comp Ieted.Then the start_io 
told information will be sent to the event mailbox. Only this time, 
a signal is given to hardware to enable megabus 10 reception. The 
operation is under the Kernel O.S. environment. 
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2. EXTERNAL SPECIFICATION 
2.1 OWNED DATA STRUCTURES 

A data structure is created to handle I/O orders. The "c" 

Dec Iaration: 


struct 


struct 


short ch_fc; /* 

long *16_address;/* 
short range; /* 

tIOITEM 
§ 

I0ITEM io IlstOC32]j 

I0ITEM io“listl[32]; 

I0ITEM Io_lIst2[32]; 

I0ITEM ioj Ist3[32]; 
tDataDes; 


channel number and function code */ 
Level 6 memory address */ 
range */ 


/* first io queue I 1st »/ 
/* second io queue list */ 
/# third Io queue list */ 
/* fourth io queue list */ 


The physical 


II 

II 

II 


II 

1 

II 


II 

II 

11 


H 

II 

II 


layout for DataDes: 

- 800400 

II 

II 

K 

- 800500 

11 

U 

II 

- 800600 

H 

II 

1 

. 800700 

II 

II 

II 


I0LD queues struct 



A mailbox table for 64 channels and an Event is created during 
startup. This table contains all mailbox Ids. When an told comes 
the channel associated with this fold will be used to pickup the 
mailbox id from the table and dispatch to that mailbox. An zero 
entry will dispatch to the event mailbox. A read or write command 
to the table is permitted any time. 
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2.2 EXTERNAL INTERFACES 

The 10 Dispatcher is driven by two external events. A 
channel mailbox registrati on(write channel mailbox id) or read 
channel mailbox id is accomplished with the O.S. sendmsg call. The 
message type is register normaI,register event, read normal,or 
read event. The "c" Declaration for the message: 


struct chan_mbid § 

MSG m /* 

short chan_nmb /* 
MBID mb t d /* 

MB ID ret_mbid /* 
short ret_code /* 
+ ; 


kernel message header */ 
channel number bit 10 - 15 */ 
mailbox id for this channel */ 
return mail box id */ 
normal = 0,undefined type=-1*/ 


When an event mailbox is registered for the first time the 
start I/O iold being queued up by the prom firmware is sent to the 
event mailbox and hardware is enabled to accept any 10 oders. 

When the cpu issues an 10 order to lac controller the hardware put 
it into the queue and cause a level 4 68000 interrupt. The 10 

Dispatcher is activated and uses the following "c” declaration 
to dispatch the iold: 



struct IoIdmsg§ 
MSG m 
short chanfc 

I on-g *l6_addr 
short Icb inf 


/* kernel message header */ 

/* channel number and function code*/ 
/* bit 0 -9 channel# 10 - 15 = IOLD*/ 
/* Icb address in Level 6 */ 

/* protocal id and Icb size */ 
t; 


2.3 INITIALIZATION REQUIREMENTS 

The initialization and main entries are part of the system 
table,CS1 file. When the system is up this process is also 

ready. The mailbox id for this process is "I0DISP". The mailbox 
table is created and is cleared to zero. 10 queues are setup and 
cleared to zero. The dma chip is setup and is ready. However, 
Registration of the interrupt routine to handle 10 with the O.S. 
must done when the system is powered up. No 10 orders would be 

accepted until event registration is completed first. 


2.4 TERMINATION REQURIEMENTS 

There is no termination requirement for this 10 Dispatcher as 
long as the Lacs board is up. 
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2.5 ENVIRONMENT 

The code is in "c" control megabus interface and operate under 
the environment of the Bridge Kernel. 


2.6 TIMING AND SIZE REQUIRMENTS 

The size of this module is approxmately 2k words. 


2.7 ASSEMBLY AND LINKING 

The source code name for this is Iac_ lo.c and is in the 
directory /usr/dvI p/megabus. The binary file I ac_ io.b must 

linked with the usr/dvI p/kernel to create a loadable bound unit. 


2.8 TESTING CONSIDERATIONS 
None 


2.9 DOCUMENAT ION CONSIDERATIONS 

The source code Is written In "c" language and is 
seIf-expIanatory. 

2.10 OPERATING PROCEDURES 

None 


2.11 ERROR MESSAGES 
None 
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3. INTERNAL SPECIFICATION 

3.1 OVERVIEW 

The basic function of the 10 Dispatch is to honor the requests 
from users to register or obtain channel mailbox id for a given 

channel. An I0LD interrupt handler is implemented to assemble and 
dispatch I0LDS that are placed by the hardware in the 

pre-assigned queues. The module is linked and run under the 

control of the Bridge Kernel. 

3.2 SUBCOMPONENT DESCRIPTION 

3.2.1 10 HANDLER 

This handler is hardware interrupt driven. Upon entry Into the 
routine it scans the hardware queue for iold. The channel number 

associated with the iold will be used as an index to the channel 

mailbox table to obtain the mailbox Id. Then the Iold will be 

dispatched to that mailbox Id. The routine resumes scan until all 
iolds are dispatched. 

3.2.2 CHANNEL MAILBOX REGISTRATION 

A channel mailbox table is setup to accommodate all 64 

channels plus and event mailbox Id. A user may send a 

registration message to request to put an entry for or read a 

particular channel or event Id. When a user registers the event 

mailbox id with this component for the first time It will 

dispatch the start 10 IOLD which Is placed by the prom ftrmware 

in specific temporary buffer to the event mailbox Id. The 

component is always ready to receive from its own mailbox for 

messages. A brecelve is called. 

3.2.3 10 QUEUE REQUEST INTERRUPT HANDLER 

When the DMA chip runs out a queue It interrupts for another 
one. The routine responds the request by consulting the list 

which will specify which one of the four queues should be 

programmed into the chip . Before returning to the Kernel it must 
reset the block- transfer complete bit in the channel status 

register. 

3.3 FUTURE DEVELOPMENT AND MAINTENANCE 
as requI red 
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4. PROCEDURAL DESIGN 
none 




